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This book introduces DL/I-Entry DOS/VS to the executive, 
system programmer, or application programmer and gives a 
general picture of what DL/I-Entry is. 


The DL/I-Entry data base system makes data handling easier 
for application programs, and centralizes the data required by 
more than one application program. Both batch programs 
running under DOS/VS and online programs running under the 
the Customer Information Control System/DOS/VS (CICS/VS) 
can use DL/I-Entry. 


This book explains the advantages of using data bases, gives a 
general description of DL/I-Entry data bases and of how 
application programs use them, and lists machine configuration 
requirements. Examples are provided of using DL/I-Entry to 
control the ordering and distribution of products, to produce a 
bill of materials in a manufacturing application, and to provide 
a complete system for order entry and production planning and 
control in the process industry. 


Prerequisite to understanding this book is some familiarity with 
the use of computers to process data. 
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Preface 


This book introduces the Data Language/I-Entry DOS/VS (DL/I-Entry DOS/VS 
or DL/I-Entry) data management control system. The book explains the 
advantages of using data bases, gives a general description of DL/I-Entry data 
bases and of how application programs use them, and lists machine configuration 
requirements. Examples are provided of using DL/I-Entry in distribution, bill of 
materials, and process industry applications. 


This book is intended for the executive, system programmer, or application 
programmer. A more detailed description of DL/I-Entry can be found in the 
following publications. 


@ DL/I-Entry DOS/VS Application Programming Reference Manual, SH12-5415 
e@ DL/I-Entry DOS/VS Design and Implementation Guide, SH12-5311 
@ DL/I-Entry DOS/VS Program Logic Manual, LY 12-5017 
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This is a major revision of, and obsoletes, GH12-5115-0 and Technical Newsletters 

GN 12-5049 and GN12-5055. Information on the hierarchical direct access method 
(HDAM) has been added to the section “Data Base Organization and Access Methods” 
and at other points throughout the book. Changes or additions to the text and 
illustrations are indicated by a vertical line to the left of the change. 


[ This edition applies to version 2, modification level 0, of Data Language/I-Entry DOS/VS 
(DL/I-Entry DOS/VS), Program Product 5746-XX7, and to all subsequent versions and 
modifications until otherwise indicated in new editions or Technical Newsletters. Changes 
are periodically made to the information herein; any such changes will be reported in 
subsequent revisions or Technical Newsletters. 
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Introduction 


Data LanguageyI-Entry DOS/VS (DL/I-Entry LOS/VS, hereafter referred to 
as DILyI-Entry) is a data management ccntrol system developed to aid the 
Systemys37C Mcdel 115, 125, 135, or 145 user in implementing batch or 
teleprocessing applications. Teleprocessing applications may be 
implemented thrcugh the use of the Customer Information Control 
SystemyDOS/VS (hereafter referred to as CICSyVS), which provides the 
necessary interfaces to DL/I-Entry. [CULyI-Entry runs as an apgyelicaticn 
program in a virtual storage envircnment under DOS/VS. 


Today companies evaluate computer systems net only in regard to 
EIcglamming systems and hardware but also in relation to the informaticn 
needs of the total corporate envircnment. Increasing demands are made 
fcr azplicaticns that maintain and interrogate large centralized 
information files. DLyI-Entry prevides a number of features to aid in 
establishing, changing, and expanding such applications and information 
files. 


DLyI-Entry may be used to advantage with such applications as payroll 
and personnel, manufacturing bill cf materials, inventory control, 
acccunts receivable, hospital records, student records, petroleum well 
records, and demand deposit accounts systems. Using DL/I-Entry, a 
ccmpany can design its applications to interface with information files 
from remote terminals (uSing a CICS/VS interface), or to frocess 
infcrmaticn in the more conventional batch mode, or to uSe a combinaticn 
of these methcds. 


These features of DL/I-Entry, together with its ability to respond to 
freguent and anticipated high-volume information reguests, make it a 
powerful tool for the data processing user. 


General Description 


The [TL/I-Entry system makes data base processing capabilities Similar to 
these used cn large systems available to System/370 DOS/VS users. [It is 
a general-purpose data management system that satisfies a wide range of 
data kase f~rccessing requirements. DI/I-Entry Simplifies the uSer's 
task of creating and maintaining larye common data bases, cffers the 
user data inderfendence, and frees the uSer from conSideraticns of access 
methods and device characteristics. 


DLyI-Entry can be used by batch-procesSing applications or by cnline 
data communication applications. 


In batch [rccessing, single data base tranSactions regueSted by 
applications are accumulated and then processed periodically against a 
data base. Because of this elapsed time, data in the data basSe is net 
always current. The use of batch processing should depend cn how 
current the user's information must be, viewed in relaticn to the ccsts 
of other methods of processing data. 


Fer data ccmmunication applications, [Ly/I-Entry provides an online 
processor, which utilizes an interface facility to CICSYVS. DL/I-Entry 
employs existing user options and exits provided by CICSyVS. CICS/YVS is 
a transacticn-criented terminal management SyStem. This type cf systen, 
as opposed to a batch system, responds to each transaction as it is 
reguected. This eliminates the elapsed time inherent in Latch 
processing systems and allows the user to maintain current data for his 
arElicaticns. 


What is a Data Base? 


The traditicnal manner of organizing data used by applicaticn [Ircgrams 
is into data files. Each data file is physically structured to present 
data in the physical sequence and format required by a particular 
application program. When the same data is Shared by several 
applicaticns, the data is duplicated on different data files so that it 
can be presented to each applicaticn frogram in the physical sequence 
and fcrmat reguired. This duplication uses additional storage sSface and 
results in increased maintenance time and cost, since the same data has 
tc be maintained simultaneously in many locations. 


The data management portion of the DL/I-Entry system uses data 
Crganizaticn methcds that free data processing application programs from 
their dependence cn the phySical organization of data and from the need 
to duplicate data. These undesirable attributes of data files have been 
eliminated with DLyI-Entry through use of the data baSe. 


A data kase is defined as "a nonredundant collection of interrelated 
data items prccessable by one or more applications." 


All appelicaticn data is stored in one or more data bases in a 
hierarchical manner; that is, the most significant data resides on 
hierarchically higher levels while less Significant but related data 
(dependent data) appears on subordinate levels (See Figure 1). Through 
the use cf a ccnceft called "Sensitivity," each applicaticn fLrogram 
views only that data in the structure which it uses, and accesses that 
data through CLyI-Entry calls. Assume that one application reguires name 


and address infcrmation, and a seccnd requires name and payroll 
infcrmaticn. The applications share their common data (name), but cnly 
the first accesses address, and only the seccnd accesses payroll. To 
each agpplicaticn, data used by other applications -- other than commcn 
data -- does not exist. 


ADDRESS PAYROLL 


Figure 1. Hierarchical Data Base Concept 


In ~ractice, a system analyst or frogrammer Lreviews the data 
reguirements cf all applications, and then defines the data base or 
bases that can best serve those applications. To create a data base, 
the user defines to DL/I-Entry a commcn data structure and format that 
serve his applications, and then lcads his application data into that 
structure. This definiticn is called a data base deScrifticn (DBD); one 
DED is reguired for each data base. The second definition required is 
the ~regram specification block (FSB). The PSB defines tc [L/I-Entry 
for each application program the data bases used, the type of data used 
within each data base, and the operations allowed on each data base. 

One PSB is reguired for each application frogram. Both of these ccntrcl 
blocks -- the DBE and the PSB -- are used to link the application data 
in the data bases to the application frogram uSing the data. Through 
DLyI-Entry's use of the DBD and PSB, application programmers can write 
theilt -rcgrams without regard to the physical structure of data. 


Batch System 


The DLyI-Entry batch system (See Figure 2) contains the following 
functional parts: 


e DLyI-Entry nucleus 

e DLyI-Entry lcw-level code/continuity check feature 
e CL/I-Entry language interface 

e (CL/I-Entry processor 


Each cf these farts is described below. 


DL/I-ENTRY NUCLEUS 


The CL/I-Entry nucleus is the controlling part of the DL/I-Entry system. 
It receives ccnticl from DOS/YVS (step 1), initializes the DILyI-Entry 
System (step Zz), and then passes control to the uSer's application 
program (step 3). After the application frogram has finished processing 
the data bases (steps 4 through 10), the data baSes are disconnected 
from the [Lyi-Entry system (step 11) and ccntrol is then returned to 
DOS/VS (step 12). 


The DLyI-Entry lcw-level codeycontinuity check feature (Stef 4) can be 
used Ly application programs written in CCBCL, PL/I, and Assembler 
language. Ina manufacturing industry, lcw-level codes placed in the 
root segments cf a parts data base identify the components cr materials 
which make up a finished product. If used, the routine is called from 
the applicaticn frogram, and in turn issues [PL/I-Entry calls like the 
application program. 


DLyYI-ENTRY LANGUAGE INTERFACE 


The DLyI-Entry language interface 1s entered when a call tec DLyi-Entry 
1s issued ky an application program (step 5). The proyramming languayes 
fSupprerted are CCBOL, PL/I, REG II, and ASsSembler language. Each DIL/I- 
Entry call is translated to a common format and is then passed to the 
CL/I-Entry frecesscr (step 6). 


DL/YI-ENTRY PRCCESSOR 


The [LyI-Entry processor is the data manayement portion of the DL/I- 
Entry system. Through this facility, the user inSerts, retrieves, 
deletes, or replaces the data in the data bases uSed by his ajzplicaticn 
program (steps 7 through 10). As these operations are performed, the 
DLyI-Entry frccessor performs all the data maintenance taSkS Leguired cn 
the data kases. 


Legical relaticnshirs and Secondary indexing are also handled by the 
CL/I-Entry processor. Logical relationshirs are a method cf 
establishing a logical connection ketween segments unrelated physically 
-- the segments may be in different data baSe records cr even in 
different data kases. Secondary indexing, is a means of retrieving 
reccrds based cn information the records contain other than the key 
Originally used to store them. 


DLyI-Entry frevides five access methods: 

e Hierarchical sequential access method (HSAM) 

e Simple hierarchical sequential access method (simple HSALM) 

e Hierarchical indexed sequential access method (HISAM) 

e Sinfle hierarchical indexed Sequential access method (Simple HISAM) 
e Hierarchical direct access methcd (HDAM). 

The virtual storage access method (VSAM) performs data management 
setvices fcr data bases which use HISAM, Simple HISAM, or HDAM. The 
sequential access method (SAM) performs data management Services fcr 
data kases which use HSAM or simple HSAM. For a descripticn of the 


DLyI-Entry access methods, refer to "Data Base Organization and Access 
Methods"-in the "System Concepts" section. 
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Figure 2. DlLlyI-Entry Batch System 


Online System 


The DL/I-Entry online system (see Fiyure 3) executes in an cnline 
envircnment under the control of CICSYVS. Since it is ~cSsible under | © 
CICS/VS for mcre than one program to run at the same time, it is 

EFcessible fcr mcre than one application program to Simultanecusly werk 

with the same [LyI-Entry data bases. 


When a user Lreguest is entered at a terminal, CICS/VS activates and 
deactivates the application program (step 1). The DL/I-Entry cnline 
system contains the following functional farts: 


e DL/I-Entry language interface 


e DLyI-Entry precessor. 


DL/I-ENTRY LANGUAGE INTERFACE 


The online [LyI-Entry language interface is entered when the application 

FrIcgram issues a data call (Step 2). Language interfacesS are frcvided 

by the CL/I-Entry online system fcr COBOL, PL/I, and Assembler. Each ©} 
DL/i-Entry call is translated to a common format and is then passed to 

the DLyIi-Entry [frecessor (step 3). 


CL/I-ENTRY FRCCESSOR 


The cnline DLyI-Entry processor functions essentially the Same aS in the 
batch system. The processor performs all the tasks necessary to insert, 
retrieve, delete, or replace data in the data bases used by the 
application program (steps 5 through 10). The main differences of the 
cnline frecesscr from the batch processor are: 


e A special call is accepted for initiation purposes of the PL/I-FEntry 
cnline system (step 4). 


e An engueueydegueve module controls concurrent access requests tc data 


bases ky different tasks (step @). 


e The CICS/YVS file control facility in conjunction with VSAM is used 
for data base access. & 


e In deadlock situations, a special call is accepted to release all 
data bases cf a task (step 11). 
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Figure 3. DlyI-Entry Online System 


Utility Programs 


Utility programs are provided with DLyI-Entry for generating data base 
descripticns (DBDs), for generating program specification Elocks (PSBs), 
} fcr producing kLackup copies of HISAM cr HDAM data bases and reloading 
them, and fcr migrating from VANDL-1 to DL/YI-Entry. 


DATA BASE DESCRIFTION GENERATION 


The LED generation utility creates the contrcel blocks that define to 
DLyIi-Entry fcr each data base the data base name, its data structure, 
its data format, and the DL/I-Entry access method used. 


PRCGRAM SPECIFICATION ELOCK GENERATION 


The P£EB generaticn utility creates the control blocks that define to 
DL/iI-Entry the data bases used, the type cf data within each data hbase, 
and the cperaticns allowed on each data baSe by a particular ayplicaticn 
program. 


BACKUP/RELOAD 


The HISAM backugz utility unloads a HISAM data baSe intc a Sequential 
file. The HLIAM backup utility unlcads a HDAM data base into a 
Sequential file. Both utilities also perform integrity checks on the 
data kase and provide statistics about the data base structure. The 
sequential file can be kept for backufy purposes, or it can be reloaded 
into a HISAM or HEAM data base using the reload utility. The reload 
utility recrganizes the data base which it reloads. 


MIGRATION FRCM VANDL-1 TO DL/I-ENTRY 


Twc miglraticn utilities convert VANDL-1 (Vancouver Data Language One) 
data tases to [ELyI-Entry data bases. The first migration utility runs 
as an apfrlicaticn frogram under VANDL-1 and copies the VANIL-1 data base 
onto a seguential file. The second migraticn utility, which runs as a 
DL/I-Entry apfelicaticn program, loads the Seguential file produced by 
the first migraticn utility into a DL/I-Entry data base. 


System Concepts 


This section goes beyond the general descripticn of DLyi-Entry already 
given tc discuss a number of technical considerations in additional 
detail. The information is of particular interest to perscns 
Lesrcnsible fcr flanning the uSe of DI/I-Entry. 


CLyi-Entry prevides applicaticn program independence from access 
methcds, pfhysical stcrage organizations, and the characteristics of the 
devices on which the data of the application is stored. This 
independence is provided by a common Symbolic program linkage and by 
data kase descriptions external to the application program. Application 
EIcglam maintenance Should thus be SubStantially reduced. See "Data 
Base User Interface" later in this section. 


CL/I-Entry eliminates redundant data while assisting in the integration 
Cr sharing cf ccmmcn data. Most data haS many interrelaticnShifs which 
lead to significant redundancy of data storage when conventional 
CIganizaticns and access methcds are uSed. For example, manufacturing 
and engineering data is also useful te guality control. The storaye 
Crganizaticns and access methods emplcyed by [EPLyiI-Entry facilitate data 
integration with a minimum of data redundancy. However, if analysis of 
a customer's data Shows that all the data cannot be placed in a single 
ccmmcn data base, DL/I-Entry allows the uSer the additional capability 
of physically structuring the data over more than one data base. Eefore 
DLyYI-Entry, afelication programmers frequently were not able, nor did 
they have the time, to integrate other data with their own to eliminate 
redundancies withcut a major rewrite cf the application proyrams 
invclved. 


An important capability of DL/I-Entry that protects each application of 
a multiapplicaticn data base is the ccncert of data sensitivity. When 
making use cf a DIL/I-Entry data base, an application program may only 
access data which is predefined as sensitive. Each application uSiny 
the data base can be Sensitive to itS uniyue subset of data. Where an 
application has defined sensitivity tc a subset of the data within a 
data kase, mcdification and addition of ncnSensSitive data de not affect 
the ~Irccessing capability of the application. In additicn, any 
application can ke restricted as tc the types of data base operations 
made upcn its sensitive data. 


Some Definitions 


Here are scme useful DL/I-Entry definitions. 


e Segment. A data element of fixed length, containing one or more 
related data fields. A Segment iS the baSic data element that 
interfaces between the application program and DL/I-Entry, and is the 
unit in terms of which the sensitivity cf the applicaticn program is 
defined. 


e Sensitivity. A means by which the user defines which subset of the 
data segments within the data baSe can be accessed by his appelicaticn 
program and what operations (fcr instance, retrieve only) may be made 
upen the subset of the data base. This defines a logical view cf a 
data kaSse. 


e Data kase record. A set of hierarchically related, fixed-length 
segments cf cne Cr more Segment types. AS viewed by the a;jflication 
proyram, the data base record is always a hierarchical tree structure 
of segments. © 


e Data base. The major unit of data storage under DLyI-Entry. A set 
of data kase records stored in a DI/I-Entry organizaticn and fcr any 
cne of the CLyI-Entry access methods. 


Nc attempt is made at this point to relate the data baSe record or data 
base to a physical storage organizaticn or access method techniyue. 
Such ccnsideraticns are presented later in the Section. 


Data Independence 


When frecessing traditional files instead of data baseS, [Icglams 
usually deal with a whole record at a time. Any chanye to a record 
structure invclves changes to all the programs which use that record. 
Cften this is true even for programs which do not actually handle the 
Changed data. The programs are "data dependent." 


DL/I-Entry, hcewever, offers "data independence." This is achieved in 
twc ways. First, programs handle only a Segment at a time, rather than 
a whole record. This means that only changes to the information which a 
proyram actually handles necessitate changes in the program. 


Seccnd, fIcgrams are only aware of those segments to which they are 
sensitive. If a segment to which a program is not Sensitive is added tc 
a data base, deleted from it, moved within it, or changed to contain 
different data, nc changes are needed for that particular frogran. 


In addition, [L/I-Entry frees the user's data and program from 
ccnsiderations of access methods and crganizations. The data base 
CILganizaticn fcr DLyI-Entry is hierarchical Seguential or hierarchical 
direct. To allow access to the hierarchical sequential organization, 
fceur DLyI-Entry access methods are previded: the hierarchical 
sequential access method (HSAM), the simple hierarchical Seguential 
access method (Simple HSAM), the hierarchical indexed sequential access 
methcd (HISAM), and the Simple hierarchical indexed Sequential access 


method (Simple HISAM). @ 
To allow access to the hierarchical direct crganization, DIL/I-Entry 

Ercvides the hierarchical direct access method (HDAM). (Stcrage 

Oryanization and access methods are discussed under "Data Ease 

@Iganizaticn and Access Methcds" later in this Section.) The aprlicaticn 

program interface with an organization type through the access methods 

is tctally symbclic. The application program is typically insensitive 

tc the particular Organization, access method, or device. 


Data Structures 


Arplicaticn [Icgrams written to use DI/I-EFntry deal with data 

structures. A data structure is always a hierarchical structure of. 

segments. Mcst data processing information, regardless cf industry, can 

and should ke viewed in a data structure. Personnel is chosen here for 

explanatcLly [furpeses because it is a familiar type of application. 

Additional examples are presented in the "Sample Applicaticns" section. & 
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The traditicnal manner of depicting data can be seen in Figure 4. This 
figure describes the phySical makeup cf the record aS it might affpear cn 
tape or on a direct access stcrage device. Each of the three divisions 
-~- NAME, ADDRESS, and PAYROLL -- is called a field. These fields 
usually contain more baSic data elements. For example, one of the data 
elements typically included in the PAYROLL field is rate cf jay. In 
addition, the record might actually ccntain multiple ALLDRESS and PAYROLL 
fields fcr a single NAME. This is typical if address and fayroll 
histcry are desired. 


ADDRESS PAYROLL 


Figure 4. MTraditicnal Record Layout 


This same data record appears in Figure 5 aS a DL/I-Entry data 
structure. The NAME, ADDRESS, and PAYROLL fields are now considered 
Segments cf infcrmation. Each segment of information is ccnsidered tc 


be made up of fields. Rate of pay would be a field within the PAYROLL 
segment. 


The data structure in Figure 5 represents a hierarchical relaticnshi,. 
Data relaticnshifs described by this hierarchical picture have only cne 
segment at the first level in the hierarchy but may have multiple 
segments at subcrdinate levels in the hierarchy (for example, multijyle 
AITCRESS and PAYRCLL segments for cne NAME segment). Since each 
dependent segment in the hierarchy has only one parent or immediate 
Superior segment, the representaticn iS Scmetimes called a tree 
Structure. 


PERSONNEL DATA BASE 


ADDRESS PAYROLL 


Figure 5. Hierarchical Record Laycut 
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Thrcugh the ccnceft of [rogram Sensitivity, ULyil-Entry allcws a frcgram 
tc be written in such a manner that it sees only thoSe segments cf 
information that are relevant tc the frocessing being perfcrmed. Fcr 
example, a payroll program could Le written to see only the NAME and 
PAYROLL segments cf the data base reccrd shown in Figure 5. ‘The freogram 


need not ke aware of the existence of the ACLDRESS segment. 


The CLyI-Entry data base capabilities allcw for handling hierarchically 
related data structures of cconSiderable variance. The maximum number cf 
segment types is limited to 62 fer data base record. A maximum of 15 
segment levels can be defined in a data baSe Lrecord. 


Figure 6 represents an example cof a data structure for a skill data 
base. The structure consists of two segment types, SKILL and NAME. The 
data structure shcws that SKILL is the root Segment, or highest Segment 
in the hierarchy. The NAME segment is a dependent segment cf SKILL. A 
dependent Segment relies cn Scme higher level segment for its full 
meaning cr identification. Since the number of employees (NAME 
segments) may vary from cne skill classification (SKILL Segment) tc the 
next, it is necessary for data base records to vary in size according to 
the number cf SsegmentS occurring in the hierarchy for the data 


Structure. 


SKILL DATA BASE 


SKILL 


Figure 6. TEata Structure 


Figure 7 shcws a Specific data base record from the data structure 
described in Figure 6. The reot segment contains the specific skill of 
artist. There are multiple NAME segments. In this case, there are 
three emplcyees whe have some capability as artists: Adams, Jcnes, and 
Smith. Although the data base can be described as having two segment 
types, this farticular data base record consists of four Segments 
because of the multiple occurrences of the NAME segment. 


The segment types immediately above and belcw a given segment type are 
called the farent and child Segment types, Lrespectively. In Figure 7, 
the SKILL segment for artist is the parent of three NAME segments. Each 
NAME segment 1s a child segment of the SKILL segment. All occurrences 
cf a articular segment type within a data base record are called twin 
segments. The three NAME segments for Jones, Smith, and Adams are twin 


segments. 


SKILL DATA BASE 


SKILL 
(ARTIST) 


NAME 
(ADAMS) 


Figure 7. Tata Base Record Structure (Derived from Figure 6) 


Logical Relationships 


Through the use of logical relaticnships, lcgical data structures may be 
ccnstructed fcr use by apfrlications where the logical data structure 
does not exist aS a Single physical data base record. A lcgical data 
structure may be composed of segments from One or more fhySical data 
base records connected by logical relationships. Logical relationships 
between segments in different physical data baSe records allow fcr 
Separation of logical data structures from physical storage. 


A lcgical relaticnship may exist ketween segments in one or more HISAM 
data tases, cne cr more HDAM data bases, or a combination cf HISAM and 
HOAM data bases. Symbolic pointers are used to establish a logical 
relaticnshif. 


LCGICAL RELATIONSHIPS BETWEEN PHYSICAL DATA BASES 


Logical relationships serve as the means by which DL/I-Entry can store a 
Ehysical segment cnce and provide access to that data Segment through 
multiple paths, thus avoiding redundant data. 


If a lcgical relaticnship as shown in Figure @ is estaklished from the 
root segment SKILL in the skill data base to the root Segment NAME in 
the personnel data base, the two physical data bases are interrelated. 
The lcgical relationship is actually constructed with the helfr of the 
dependent segment REFERENCE NAME. Rather than duplicating the NAME 
segment in bcth data bases, the skill data baSe now contains cnly a 
reference to the NAME segment stored in the personnel data hbase. 
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SKILL DATA BASE PERSONNEL DATA BASE 


ADDRESS PAYROLL 


Figure 8. Unidirectional Logical Relationship Between Physical Data 
Bases 


Logical 
Parent 


Logical Relationship 


REFERENCE 
NAME 


Logical Child 
Segment 


The segment REFERENCE NAME providing the logical relationship path from 
the SKILL segment to the NAME segment is called a logical child Segment. 
The segment NAME which is related to the logical child Segment REFERENCE 
NAME is called a logical parent segment. A logical parent segment must 
always ke a reot segment. In this example, the logical child segment 
REFERENCE NAME has a logical parent Segment NAME and a physical parent 


segment SKIIL. 


The logical relationship path runs only in the direction from the 
legical child segment towards the logical parent Segment, and is called 


Several occurrences of the REFERENCE NAME segment under different SKILL 
segments may relate to the Same logical parent Segment NAME. Each 


eee es ee ee ee eee ee ne ee eee ee ee ee 


unigue tc the relationship between a particular SKILL and NAME Segment. 


Having established a unidirectional lcgical relationship between the twe 
physical data tases, a new logical data structure can be defined as 
Shcewn in Figure 9. Note that the REFERENCE NAME segment and NAME 
segment are ccncatenated and presented to an application program as one 
segment. 


Using the logical relationship, data in bcth physical data bases can be 
accessed and mcdified. Fcr example, if the key field of a given SKILL 
segment is kncwn, the SegmentS REFERENCE NAME-NAME, ADDRESS, and PAYROLL 
can ke examined. 


All cccurrences cf REFERENCE NAME-NAME, ACDRESS, and PAYRCLL segments 
under a particular SKILL seyment become a 1lcgical data base record. The 
segments in this logical data base record may be accessed Ly an 
afrlicaticn [Icgram in the Same manner aS SegmentS in a fhysical data 
base record. 


As shcewn in Figure 8, the logical child segment REFERENCE NAME 


establishes a unidirectional logical relationship path frcom the SKILL 
segment to the NAME segment. If a logical relationship path also should 
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exist in the cther direction -- from the NAME Segment to the SKILL 


segment -- a seccnd logical child segment must be intrcduced. In Figure 
10 the dependent segment REFERENCE SKILL is used to construct the second 
& lcgical relaticnshif. 


SKILL/PERSONNEL LOGICAL DATA BASE 


REFERENCE 
NAME 


ADDRESS PAYROLL 


Figure 9. Ccmbined Data Structure Viewed from the SKILL Segment 


SKILL DATA BASE PERSONNEL DATA BASE 


Logical 
Parent 
Segment 


Logical 
Parent 
Segment 


REFERENCE 
SKILL 


REFERENCE 
NAME 


PAIRED 


@ Figure 10. Bidirectional Logical Relationship Between Physical Data 


ADDRESS PAYROLL 


Fases 
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legical relaticnship, whereby the REFERENCE NAME and REFERENCE SKILL 
segments are paired. Both logical child segments have a lcgical anda 
Fhysical farent -- for instance, REFERENCE SKILL has the physical parent 
NAME and the lcgical parent SKILL. 


The logical relationship shown in Figure 10 makes possible another 
legical structure -- in addition to that which has already been shown in 
Figure 9. The new structure is that as viewed from the NAMF segment, 
Shown in Figure 11. Here the REFERENCE SKILL and SKILL segments are 
ccncatenated and fresented to an application frogram aS one Segment. 

For this example PAYROLL, not of interest, has been omitted. 


PERSONNEL/SKILL LOGICAL DATA BASE 


REFERENCE 
SKILL 


ADDRESS 


Figure 11. Combined Data Structure Viewed from the NAME Segment 


Specific cccurrences of REFERENCE NAME and REFERENCE SKILL are faired, 
wherekty they have the same intersecticn data. Figure 12 shcws an 
example of how a specific REFERENCE NAME cccurrence for Jones is paired 
With REFERENCE SKILL for artist. 


CL/I-Entry is responsible for ensuring the maintenance of this paired 
bidirecticnal lcgical relaticnship. If one direction of the 
relaticnshif is altered by Segment insertion or deleticn, CUL/I-Entry 
automatically maintains the other directicn. For instance, if the 
segment REFERENCE SKILL for artist in Figure 12 were deleted, REFERENCE 
NAME for Jones would automatically be deleted. 
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SKILL DATA BASE PERSONNEL DATA BASE 


SKILL 
(ARTIST) 


NAME 
(JONES) 


REFERENCE 
NAME 
(ADAMS) 


REFERENCE 
SKILL 
(ARTIST) 


REFER- 


REFER- 


ENCE ENCE 

NAME SKILL 

(JONES) ce (DRAFTSMAN) eee 
NAME SKILL 


(SMITH) (DESIGNER) 


PAIRED 


Figure 12. Pairing Specific Segment Occurrences 


Some general rules regarding the seyments which participate in a loyical 
relaticnshif are: 


1. A logical child segment must always have a logical parent and a 
Fhysical farent -- therefcre it cannot exist as a root segment. 
Hcwever, it may exist at any dependent level in the phySical hierarchy. 


Z.- A logical child segment can have only cne logical parent and one 
Fhysical farent. 


3. Only cne lcgical child segment is fermitted in a given franch of the 
tree-like hierarchical data structure. 


4. A lcgical child Segment can have nc dependent segments. 

5. A lcgical farent segment must be a root Segment. 

6. A logical parent segment may have cne cr multiple logical child 
Segment types. Each lcgical child Segment type depends cn cne 


logical relationship. 


7. Only cne lcgical relationship can ke used to define a given branch cf 
the tree-like hierarchical logical data structure. 
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Secondary Indexing 


Secondary indexing 1S a Special way of retrieving data base records & 
(HISAM and HDAM cnly). Instead of retrieving them kased cn the 

sequential order of the key of the roct segment, they are retrieved 

based cn the seguential order of the Secondary index. 


Seccndary indexing is made possible by creating a new data kasSe called 
the index data kase. For example, in Figure 13 the segment X (which 
might be a farticular job title) would be the index pointer Segment cf 
the index data base. It contains the data used to index the 

index target segment, NAME. The index taryet segment must be the root 
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segment cf the indexed data baSe. The index Source segment, LEPARTMENT, 
is the scurce cf the search data from which a Secondary index is 
created. The index source segment may be a root or a dependent segment 
(in the example it ig a dependent Segment). The Secondary index has the 
seguential order of the search data values. An application program can 
thus retrieve cccurrences of the index target Segment LtaSed cn the 


seguential order of informaticn contained in the index source segment. 


PERSONNEL DATA BASE INDEX DATA BASE 


Index Index 
Target ¢-------------- X Pointer 
Segment Segment 
aA 
7 
7 
7 
7 
7 
7 
a7 
7 
7 
Index 
ADDRESS DEPARTMENT Source 
Segment 
Figure 13. Seccndary Index Data Base 
Fcr each cccurrence of a DEPARTMENT Segment, DL/I-Entry would © 


automatically maintain the index pointer segment in the index data base, 
ag shcwn in Figure 14, 


More than one secondary index can be kased on the Same index source 
segment tyre, and the indexes may use search data which is different, 
cverlaz;fing, cr the same. 


The advantages offered by seccndary indexing can be seen by considering, 
fcr instance, an application program which needs to retrieve all NAME 
segments within a single department. This is done much faster using the 
seccndary processing sequence of the index data base rather than 
retrieving each record in Sequence from the original data kaSe in crder 
to check for the desired department number. 
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PERSONNEL DATA BASE INDEX DATA BASE 


NAME 


0490 
(23132) 


0490 
(65956) 


DEPARTMENT 


Figure 14. Secondary Index Data BaSe Example 


Low-Level Codes 


In a manufacturing industry, low-level codes p-laced in the root Segments 
of a parts data base can be used to identify the components or materials 
Which make up a finiShed product. DL/I-Entry offers a low-level | 
code/continuity check feature which batch application programs written 
in COBOL, PL/I, or ASSembler language can call to generate, check and 
update such low-level codes. Programs which use the feature are upwards 
scurce program compatible with DL/I DOS/VS Version 1.1 and subSequent 
versions. 


Data Base User Interface 


Application programs (except those written in RPG II) reguest DL/I-Entry 
services uSing a CALL statement. The DL/I-Entry CALL statement is 
compatible with VANDL-1 and DL/I DOS/VS. The CALL statement can reyuest 
DL/I-Entry to: 

e Retrieve a unigue seyment (GET UNIQUE). 


e Retrieve the next segjguential segment (GET NEXT). 


e Retrieve the next sequential segment within an eStablished parent 
(GET NEXT WITHIN PARENT). 


e Replace the data in an existing segment (REPLACE). 

e Delete an existing segment (DELETE). 

e Insert a new Segment (INSEPT). 

The RPG II programmer has two possibilities for reguesting DL/I-Entry 


Services. First, he can control them "implicitly," without making 
explicit requests. With this approach he can retrieve DL/I-Entry data 
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base rteccrds sequentially, and can update them or produce cutgut to 
other files. He cannot, however, process segments non-seguentially, or 
add segments, cr delete then. 


Ey using "explicit" input and output, however, the RPG II froyrammer can 
Erccess a data base both sequentially and ncnseguentially, and can add 
and delete segments aS well aS being able tc retrieve and uydate then. 
He reguests services uSing RPG II REAL and EXCEPT statements. The [L/I- 
Entry data bases are defined in his program aS Special files. 


A common symkclic program linkage handles the COBOL, RPG II, PL/I, and 
Assembler languages. The external data base description (LED) yives the 
data structure and physical data organization of each data base to DL/I- 
Entry. Using these technigues, it is possible to physically reorganize 
established data bases in a timely manner without modifying appylicaticn 
programs. Inputyoutput operations and associated system ccntrol blocks 
are nct ccmpiled into the apfrlication programs. 


Fach LEE is created from user-provided statements which define the data 
structure and fhysical organization of the data base. These statements 
are read by the DLyI-Entry DBE generation utility, which creates and 
stores the [TEL. The DBD then provides DLyI-Entry with a "map" from the 
structure cf the data base used in the application program to the 
physical organization of the data used by DCS/yVS data management. Cther 
az~plicaticn data can be added to this data baSe without necessitating 
changes to the application programs which use the data. The concept of 
the DBD reduces afflicaticn frogram maintenance caused by changes in the 
data requirements of the applicaticns. 


Data Base Organization and Access Methods 


DL/I-Entry supports two basic physical stcrage organizations, 
hierarchical seguential and hierarchical direct. The hierarchical 
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sequential organization provides the kasis fer four access methods: 

e Hierarchical seguential access method (HSAM) 

e Simple hierarchical Sseguential access method (Simple HSAM) 

e Hierarchical indexed Seguential access method (HISAM) 

e Simple hierarchical indexed seguential access method (Simple HISAM). 
Simple HSAM and simple HISAM process root-only data bases. 


‘The hierarchical direct organization frovides the basis fcr the 
hierarchical direct access method (HDAM). 


Segments that represent one data_ base record (that is, a fhysical 
hierarchical tree structure) are related either by physical 
juxtaposition (HSAM or Simple HSAM), Ly symbolic pointers (HISAM or 


Simple HISAM), or ky relative byte addresses (HDAM). 


HSAM and simple HSAM are used for sequential storage and access cn tafe 
or direct access storage devices. The DOS/VS seyuential access methcd 
(SAM) provides the data management services for these access methods. 


HISAM and Simple HISAM are used for indexed Sequential access to the 
hierarchical seguential organizaticn. The LCOSyYVS virtual stcrage access 
method (VSAM) provides the data management services. A HISAM or simple 
HISAM data base ccmprises one VSAM key Seyuenced file. Each data base 
record starts with a root segment contained ina VSAM record. AS many 
dependent segments of that root Segment aS can be accommcdated are 
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placed in the VSAM record (for HISAM cnly). Overflow dependent segments 
fcr that root segment are stcred in additional VSAM records. Symbolic 
Ecinters relate all phySical records for cone HISAM data base reccrd. 


HEOAM is used for direct storage and access. The LOS/VS virtual stcrage 
access method (VSAM) provides the data management services. The purpose 
cf HDAM is tc give fast, randcm access to data. A HDAM data base 
comprises a VSAM entry seguenced file split into a root addressable area 
and an cverflcw area. The root addressable area contains the beginnings 
(the root segments and some dependent segments) of data base records. 

In a well designed data base this is the information mcst cften 
processed. The overflow area contains the continuations (the remaining 
derendent segments) cof the data base records. This is the informaticn 
less often prccessed. 


Lcygical relationships and seccndary indexing are possible cnly with 
HISAM and HDAM. 


Segment Definition and Format 


The fcregcing discussion has introduced Some of the concerts used in the 
physical stcrage of data. The term "data base record" was used. The 
data base reccrd is represented aS a Simple hierarchical tree structure 
of related segments. 


Each segment, regardless of the access method used, 1S comjpcsed cf two 


The fcrmat cf the prefix for any Segment type iS unique and is 
determined Ly the data base organization. The use of the segment prefix 
is ccentrclled entirely by DLyI-Entry. An application fregram need nct 
be concerned about the presence or the format of the Segment prefix. 

The data ferticn cf a Segment may optionally begin with a key field to 
contrcl the fhysical Sequence of occurrences of that Segment tyfe. Only 
the data portion of a segment is fassed between an application program 
and DLyI-Entry. 


Online Processing Capability 


DLyI-Entry functicns may be extended to an online environment thrcugh 
CICS/VS. CICS/VS, a general-purpose data baseydata communication 
system, functicns as an interface between DL/I-Entry and affrlication 
programs written in COBOL, PLylI, or Assembler language. cCICS/YVS makes 
it pessible fcr more than one application frogram to Simultanecusly werk 
with the same DLyI-Entry data bases. 


In addition to serving as an interface with DLyI-Entry, CICS/YVS offers 
the applicaticn fLrogrammer a uSer exit facility for optional f[rocessing 
routines, and macros for requesting CICS/VS Services. FOr more 
infcrmaticn abcut CICS/VS, refer to Customer Information 
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Centre] _System/DCS/VS_General_ Information, GH20-7028. 


User Responsibilities 


Installation personnel must be adeguately trained in using DPL/YI-Entry. 

Tlaining can take the form of classrocm instruction or Self-study uSing 
the ClyI-Entry documentation. In addition, if the user intends to Lun 

DL/I-Entry in an online environment, the installation perscnnel must be 
sufficiently trained in using CICS/VS. 


The user must either have an existing VANDL-1 data base, or else have 
ccllected data frcom which he wants to build a new DL/I-Entry data kLaSe. 
The time required tc convert an existing VANCTL-1 data base to Lun cn 
CL/I-Entry is approximately cne day per data base. Users not cominy 
frcm a VANDI-1 environment will reguire Slightly more time tc generate a 
data kase, since the input for DBD and PSB generation must be written 
fer the first time. Once this input iS written, however, generaticn 
Should require less than one day fer data base. 


ArpgElicaticn fregrams written for VANDL-1 reguire no conversion. Cther 
application programs require modification in order to uSe the DL/I-Entry 
CALL statement and to follow CL/I-Entry conventions. 


The steps a system frogrammer must perform in order to migrate from 
VANCL-1 to [LyI-Entry are summarized in Figure 15. The steps the system 
and agpfplicaticn fIregramming personnel of a new CPL/YI-Entry installaticn 
must perform to install DL/I-Entry are summarized in Figure 16. 


System Programmer 


Read DL/I-Entry Design and Implementation Guide, SH12-5311. 


install DL/I-Entry system and run the sample problems. 


Change old DBD input and generate a new DBD by using the DL/I-Entry 
DBD generation utility. 


Take old PSB input and generate a new PSB by using the DL/I-Entry 
PSB generation utility. 


Run DL/I-Entry migration utilities to transfer VANDL-1 data base into a 
DL/I-Entry data base. 


Production runs can now be made using the VANDL-1 application programs. 


Figure 15. Migraticn from VANDL-1 to CL/I-Entry 


RO 
N) 


System Programmer 


Read DL/I-Entry Design and 


Implementation Guide, SH12-5311. 


Install DL/I-Entry system and 
run the sample problems. 


Design data base and inform 
application programmer about 
data base structure. 


Perform DBD and PSB generations. 


Create data base. 


Application Programmer 


Read DL/I-Entry Application 


Programming Reference Manual, 
SH12-5415. 


Obtain information from system 
programmer about data base 
structure. 


Code, test and debug application 
program(s). 


Make production runs. 


Figure 16. Installing DL/I-Entry at a New Installation 
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Programming Systems 


CL/I-Entry will run exclusively on the Systemy370 under [CCSyYVS. DL/I- 
Entry is alsc supperted under DOS/yVS running under the ccntrel of 

VY /737C. TLyiI-Entry is written in Assembler language and uses the 
virtual storage access method (VSAM) and sequential access method (SAM) 
data management facilities. The follcwing components cf the DOS/VS SCP 
(5745-010) are reguired: 


e cCecntrcl and service fprcgrams 
- Initial [regram loader 
- Superviscr 
- Jcb ccnticl 
- Linkage editor 
- Relccating lcader 
- Likrarian 


e Assembler 


e Data management 
- Seguential access method (SAM) 
- Virtual stcrage access method (VSAM). 


In addition tc the above DOS/VS components, the uSer may Lreguire the 
following: 


e DOSYVS CCBCL Ccmpiler and Library, 5746€-CE1. 


e Full ANS CCBOL V3 Ccmpiler, 5736-CE2, and Full ANS COBOL Library, 
5736€-LM2. 


e PLyI Optimizing Compiler, 5736-EL/I. 
e PL/I Resident Library, 5736-LM4. 

e PIyI Transient Library, 5736-LM5. 

e RPG II Ccmpiler, 5736-RG1. 


For cnline executicn of DL/I-Entry, the Customer Informaticn Ccontrcl © 
| Systemy/LOSyVS (CICS/VS), 5746-XX3, is required. 
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System Requirements 


A minimum machine configuration fer DLyI-Entry is outlined below. The 
differing requirements for a PLyI-Entry batch system and fcr a DL/I- 
Entry system having an online processing capability are identified. 
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Cirect Access 


Gther I/C 


An IBM Systemy370 Model 115, 125, 135, 
145, or 158. The DL/I-Entry batch system 
requires 1CK bytes of real storage and 
32K bytes cf virtual stcrage fcr 
execution. The DLyi-Entry cnline systen 
requires 12K bytes of real stcrage and 
34K bytes cf virtual storaye for 
execution. 


For system libraries and working stcrage 
Space: any direct access stcrage devices 
Supported by UCOS/VS. 

Minimum space for system use and 
maintenance: 


Batch System ZO cyl IEM 2316 
Disk Pack or 
equivalent 


Online Systen 4Q cyl IEM 2316 
Disk Pack cr 
eguivalent 


For DLyI-Entry data base storage, within 
the capability and restricticns of DOS/VS 
Support by the virtual storage access 
method and Seguential access methcd: 


IBM 2314/2319 Direct Access 
Storage Facility 

IBM 3330/3333 Disk Stcrage 

IBM 3340 Direct Access 
Storage Facility 


One IBM 256C Card Reader/Funch 

(OL equivalent), 

one IBM 3203 Printer (or equivalent), and 
(ceguired for online only) any terminal 
supported by CICS/VS. 
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Estimated Storage Requirements 


The following is an example of the stcrage reguirements for a DL/I-Entry ©} 
batch apfplicaticn program which utilizes the basic DLyI-Entry functions 

and accesses two HISAM or HDAM data baSes. The total virtual stcrage 

requirements are 94K bytes. The tctal real storage reguirements are 20 

Fages (4CK bytes). This iS an estimate of the lowest number cf fage 

frames required for reasonable performance without "thrashing." 


Se 

[ |Virtual| Real | Comments | 

| | (bytes) |] (pages) | | 

| ene | 
|] |CL/I-Entry ccde | 34K | 5 {Only 5 pages. (10K) have | 
| | | jheavy usage and therefore | 

| | | jwill always be in real | 

| 

| 

| 


| | | jstorage. 
| --—------~-------~---_ + ee 
| CL/I-Entry werking storage| 2K 1 { 
| -----~--------------------------------—----------------------—------ | 
|CLyI-Entry ccntrol kElocks | 2K 1 {Approximately 1K fcr each | 
| | l |HISAM or HCDAM data base. | 
| -------------- + -- - ——-—— | 
}VSAM mcdules: | | JApproximately 60% of VSAM | 
{reccrd management {| 28K | 7 jis "once per jcb" code. | 
| (CPEN/CLCSE processing | | | 
| 142K) | | | 
| a nn | 
}VSAM ccntrecl bliccks | UK 2 {2K for each VSAM data set. | 
|—-----— a a A a | 
|VSAM buffers and | 8K | 2 14 buffers for each data | 
{|DLyI-Entry IyO areas | | |base. [ 
| | | {Control interval size is | 
| | | 11024 bytes (1K). | 
| -—--—-—-——-——__—---—- --— -—--— -— ——_—_ —__-— ae oe re ee ae —-—- | 
[Subtctal (executicn mode) | 78k |] 18 }18 pages = 36K bytes. | 
Ym ene | 
[Application frogram ; 16K | 2 | | 
en rn nnn nr | 
[| | Total (execution mode) {| 94K | 20 {20 pages = 40K kytes. | © 
bo ee —_——— — J 
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Sample Applications 


This secticn fresents several data baSe application examples. Each 
example shows the data base structures used for a specific application, 
and the types cf inguiries which the data baSes could ke expected tc 
handle. Althcugh only three sample applications are given, these 
samples are ccnstructed in a general way, So that the techniques they 
illustrate apply to a wide variety of other applications. 


Distribution Example 

A sample application of DL/YI-Entry in distribution uses these three data 
bases: 

e Product data kase 

e Customer index data base 

e Sujyplier index data base. 

These data bases are Shown in Figure 17. In the following text, the 


individual fields which might be ccntained in the segments are 
described. 


SUPPLIER INDEX PRODUCT DATA BASE CUSTOMER 
DATA BASE INDEX 
DATA BASE 


SUPPLIER) --———————--—-—--— > 2S 5555 5=25> CUSTOMER 


PRODUCT 


PRODUCT NO. 


CUSTOMER 
ORDER 


CUSTOMER + 
ORDER NOS. 


PURCHASE 
ORDER 


SUPPLIER + 
ORDER NOS. 


Figure 17. TLCistribution Vata Bases 


PFCLDUCT LATA EASE 


The preduct data base is made up of four Segment tyfes on twe 
hierarchical levels. The records are stored in ascending seguence based 
urcn the preduct number. 


The product numker is the key of the root segment, the PROLTUCT segment. 
In additicn this segment contains: 


e The product description. 
e Overall sales information (Such as saleS values, SaleS ;,eriods, 
statistics). @ 
The PURCHASE ORDER segment contains: 
e The su,;pflier number followed by the order number, uSed toyether as 
the segment key. 
e The amount on order and the cost. 
e The delivery date and address. 


e cConfirmaticn status. 
The INVENTO?Y segment contains: 


e The guantity on hand and stock location {in periods). 


e The guantity in p~roduction (in ;eriods). 


e The juantity on order (in periods), broken down into the juantity on 
customer crder and the yuantity on purchase order. 


The CUSTOMER ORDER Segment contains: 


e The customer number followed by the order number, used toyether as 
the segment key. 


e The amount on order and the cost. 
e The delivery date and address. 


e Confirmation status. 


SUPPLIER INDEX DATA BASE 


The Supplier index data baSe iS created and maintained by DL/i-Entry. 
It is made up of a single segment type, the SUPPLIE® segment. This 
segment contains information to relate, to a given Su,j;lier and order 
number, the correspondiny product number(s). 


CUSTOMER INDEX DATA BASE 


The customer index data baSe iS created and maintained by DL/I-eintry. 
It iS made up of a single segment type, the CUSTOMER segment. This 
segment contains information to relate, to a given customer and order 
humber, the ccrresponding ;roduct number(s). 


28 


INQUIRIES USING THESE DATA BASES 


Any application program accessing the product data base may use one of 
three possible addressing Schemes. That iS, a particular PRODUCT 
se,ment may be accessed usSing either: 


1. The product number (key of the root Segment). 


2. The supplier number plus the order number of one of the PURCHASE 
ORDER segments dependent on the PRODUCT segment. 


3. The customer number plus the order number of one of the CUSTOMER 
ORDER segments dependent on the PRODUCT segment. 


For seguential processiny, each of these addressin,; schemes defines a 
different precessing seguence for the product data base. 


If the supplier index data base were used to provide the secondary 
processing sSeguence for the product data base, all products ordered fron 
a particular supplier could be retrieved and updated for purchase 
Flanning. The quantities ordered from the Supplier, and the delivery 
dates, could be determined and perhaps modified, and the purchase orders 
cculd be checked. 


Another type of processing which could be performed with the product 
data base, based on the Secondary processing sezyuence indicated by the 
Supplier index data base, would be to control purchaSe orders. 
Production chanyes necessary because of late delivery could be 
determined, as could the effect on customer orders for a particular 
product. 


Using the other index data base, the customer index data baSe, to 
provide the secondary processing seguence for the product data base, the 
list of products for a particular customer could be obtained or 
mcdified, fcr use by sales or to aid in planning shipment. 


In this way, a number of inguiries could be made uSing the index data 
bases. These inguiries will perform considerably faster than searching 
the product data base following its primary Seguence eStablished by the 
product number to select the desired information. 
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Bill of Materials Example 


In manufacturing, a bill cf materials for an assembly can ke [refared © 
when the compcnent parts of each particular item of the assembly, and 
the lccaticn where the parts are used in the item, are kncwn. Fcr a 
| sample item A, Figure 18 shows what might be the data structure for the 
bill cf materials. In addition, this figure shows the DLyI-Entry data 
base which cculd represent the bill of materials. 
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| Figure 18. Bill of Materials Data Structure and Item Physical Data Base 


The data base shcwn, the item data base, is made uy of three Segment 
types on two hierarchical levels. The ITEM segment contains the item 
number as segment key, the item name, and the item description. The 
COMPONENT ITEM REFERENCE Segment contains only a key, the item number. 
The WHERE-USEL REFERENCE segment also contains only a key, the iten 
number. The latter two Segments are used to establish lcgical 
relationships with the ITEM segment. They may optionally ccntain 
intersection data, that is, data unigue to the relation of a certain 
ccculrrence cf these segmentS and the corresponding occurrence of the 
ITEM segment. 


The lcgical data base structure, which is derived from the data base 
Shown in Figure 18 by using the lcgical relationships between the 
segments, is Shown in Figure 19. This is the way an application program 
wculd view the data. 


3 


® 


ITEM LOGICAL DATA BASE 


ITEM 


ITEM NO, 


COMPONENT 
ITEM 
REFERENCE 


ITEM NO. 


WHERE- 
USED 
REFERENCE 


ITEM NO. 


Figure 19. Item Lcgical Data BaSe 


INCUIFIES USING THE LOGICAL CATA BASE 


A cne-level fill of materials (explosicn) could be produced by proceding 
frcom an ITEM segment to its CCMPOCNENT ITEM REFERENCE Segment, which is 
logically related to the corresponding ITEM segment. By repeating this 
step fcr each item in an assembly, a complete explosion bill cf 
materials for the entire assembly may be developed. An example is shown 
in Figure 2C. In this example, letters are used to represent items 
which can ke further subdivided, while numbers are used to represent 
items which cannct be further subdivided. 


In step 1 of Figure 20, ITEM segments B and 1 are found as components of 
ITEM segment A, by means of the logical relationships from the COMPONENT 
ITEM REFERENCE segments B and 1 te the ITEM Segments B and 1, 
respectively. And in step 2, ITEM segment B is then broken down into 
its ITEM segments 1 and 2 also through logical relaticnshifs. 


One-level where-used information (implosion) could be preduced by 
proceding from an ITEM segment, through its WHERE-USED REFERENCE 
segments, tc the logically related larger ITFM segments. The freocess is 
Similar to that for explosion, and is shown in Figure 21 for ITEM 
segments 1 and Z in the assembly of ITEM A. ITEM 1 1S uSed in bcth ITEM 
A and E of the assembly, and ITEM 2 is used in ITEM B. ITEM B is 
further used in ITEM A. 
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| Figure 20. Explcsion Bill of Materials Example 
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| Figure 21. Implosion Bill of Materials Example 
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Process Industry Example 

A sample agffplication of DIL/I-Entry in the process industry -- in a steel e 
mill -- uses these four data Lases: 

e cCustcmer data base 

e Order line data base 

e Product data kE-ase 

e Prcducticn ctrder data base. 

These data bases ccntain all the information nheceSSary fer crder entry 

applications, and for production planning and control applications. The 


| data kases are shcwn in Figure 22. In the following text, the 
individual fields contained in the segments are described. 
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| Figure 22. Ercecess Industry Physical Data Bases ® 


CUSTCMER DATA EASE 


The custcmer data base is made up of three segment types cn three 
hierarchical levels. The first segment, the CUSTOMER segment, contains: 


The custcmer number, used as the Segment key. 
The customer name and address. 

e Sales infcrmaticn (Such as order values, 
linits). 


invoice values, credit 


The CLELIVERY ALLRESS segment yives the address to which orders should ke 
Shipped (nct necessarily the Same as the address contained in the 
CUSTOMER segment), and a location code. 


The CRLER LINE REFERENCE 
with the crder line data 
line number, used as the 


segment estaklishes 
base. This Segment 
segment key. 


the logical relationship 
contains cnly the order 


ORDER LINE DATA BASE 


The crder line data base is made up of three 
hierarchical levels. The first segment, the 
ccntains: 


Segment types cn twe 
CRDER LINE segment, 


The order line number, 

Prcduct identificaticn. 
Cuantities and values. 

The delivery date. 


used as segment key. 


Order line status, broken down into 
stock, the guantity to be produced, 


The PRODUCTICN CRDER REFERENCE segment 


the quantity allocated frcm 
and the planned production date. 


eStablishes the lcgical 


relationship with the production crder 
cnly the p~rceducticn order number, used 


data base. This segment contains 
aS the segment key. 


The PRODUCT REFERENCE segment, containing only the product number as 
segment key, estaklishes the logical relaticnshifp with the product data 
base. The FRCDUCT REFERENCE Segment iS paired with the ORDER LINE 
REFERENCE segment. The reason for this is to make DL/I-Entry 
respcnsible fcr maintaining both segments in:the event one iS changed. 


PROLUCT CATA BASE 


This data tase contains three segment types cn two hierarchical levels. 
The first segment, the PRODUCT Segment, contains: 


e The freduct number, used as Segment key. 

e The product description. 
Overall sales information 
statistics). 


(Such aS SaleS values, Sales [ericds, 


The CKDER LINE REFERENCE segment, containing only the order line number 
as segment key, establishes the lcgical relationShif with the crder line 
data tase and is paired with the PRODUCT REFERENCE segment in that data 
base. 
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The INVENTCRY segment is not involved ina logical relationship. It 
ccntains: 


The quantity on hand and stock location (in periods). r 
The guantity in production (in feriods). 

e The guantity cn order (in feriods), broken down into the guantity cn 
customer order and the guantity on purchase order. 


PRODUCTION CRUIER DATA BASE 


The preducticn crder data baSe contains three Segment types cn twe 
hierarchical levels. The main Segment is the PRCODUCTICN CRLERK se,ment; 
it describes bcth flanned and in-frocess froduction. The Segment 
contains: 


The prceduct description 

The production begin and end dates, with guantities 
Material allocation informaticn 

The checkfcint flan. 


The IN-PRCCESS INVENTORY segment ccntains the up-to-date inventory at 
Varicus fcints in the processing sequence or at intermediate stores. 


Cccurrences of the OPERATIONS segment describe operaticns during 
Erccessing. This Segment contains: 


The cperaticn description 
The operation duration 
The set-up time 

The operation status. 


INQUIRIES USING THESE DATA BASES 


The lcgical relationships established between the four physical data 
| bases shown in Figure 22 make it possible te build three lcgical data 
bases: 


e Crder entry data hbase 


e Product control data Lase 
e Prcducticn flanning and control data base. 


| these lcgical data bases, Shown in Figure 23, fresent the application 
programmer with new hierarchical structures of information, different 
frcem the structures contained in the fhysical data bases. The fcllowing 
text descriktes the types of processing that might be done with the 
ilcgical data bases. 


The order entry data base is made up of the customer data kase and the 
logically related order line data Fase. Since, however, the two 
dependent segments of the order line data base are reference segments 
defining other logical relaticnshrs, they cannot be included in the 
crder entry data base. 
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| Figure 23. Process Industry Logical Data Bases 
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The order entry data base could be used to inguire about the existing 

orders for a particular customer, and to modify these crders. For 

instance, shipment dates fcr crder lines could be confirmed and fossibly 

changed, depending on their order line status. Or delivery dates, & 
addresses, and guantities could be controlled. New custcmers and new 

order lines could be added. 


Order p-reccessing would be ancther fossible application fcr this data 
base, involving checking for valid customer numbers and addresses, 
controlling credit limits, and the like. Information might also be 
chtained fcr f-Llefparing invoices or other documents. 


Froduct_Contrel Lata Base 
The product ccntrol data base is made up cf the product data base and 
the lcgically related order line data baSe. 


Excluded from the product control data base are the two derendent 
segments cf the crder line data base, for they are reference Segments 
defining other logical relationshirs. One of these segments, the 
PRODUCT REFERENCE Segment, 1S nevertheleSS paired with the ORDER LINE 
| REFERENCE segment, aS Shown in Figure 22. The reason for this is to 
make DLyI-Entry responsible for maintaining both SegmentS in the event 
one 1s changed. For instance, if a new ORDER LINE REFERENCE Segment 
were added te the product control data base, [PLyYiI-Entry wculd add a 
corresponding ORDER LINE segment in the order line data base and also 
the apprcepriate PRODUCT REFERENCE segment in the order line data base. 


The product ccntrol data kaSe could be used to evaluate and mcdify 
Erceduction reguirements. For instance, all order lines for a particular 
Ercduct cculd be retrieved, to establish delivery dates and guantities. 
Cr decisions about production orders for a particular product could be 
made, such as the quantities needed to fill customer orders cr the 
production dates necesSary to meet specified delivery dates. 
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The production planning and ccntrcl data base is made up of the order 
line data base and the logically related production order and frcduct 


data kLases. @ 
Since the ORDER LINE REFERENCE segment of the product data baSe iS a 
logical child segment, it is excluded from the logical data base 
structure. This segment is nevertheless paired with the PRCDUCT 
| REFERENCE segment, as Shown in Figure 22, in order to make CDL/I-Entry 
responsikle fcr maintaining bcth segments in the event that one is 
changed. 


The production planning and ccntrcl data base could be*used to: 
e Insert new production orders related te the appropriate crder line, 
Cr update existing orders depending on decisions made during 


production reguirements evaluation. 


e Check crder line status, production order status, in-fprecess 
inventory, operation dates. 


e cCalculate the guantities not ccvered by allocated stock. 
e Allccate available stock. & 


e Update inventcries. 
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and data independence 10 
definition of 9 
description of 2-3,10,12 
seguential access method (see SAM) 
Shared data 2,9 
Simple hierarchical indexed sequential 
access method (see simple HISAM) 
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Simple hierarchical sequential access 
method (see Simple HSAM) 
Simple HISAM (Simple hierarchical indexed 
sequential access method) 
description of 20-21,10 
use by batch system 4,5 
use by online systen 7 
Simple HSAM (simple hierarchical sequential 
access method) 
description of 20,10 
use by batch systen 4,5 
skill data base 12-17 
skillypersonnel logical data base 15 
source segment 18,28 
special files, RPG II 20 
storage devices, direct access 20-21,25 
Storaye reguirements 26,25 
structure, data baSe 2-3,11-12 
Supplier index data base 27-29 
Symbolic program linkage 19-20,9 
system, DL/I-Entry 
batch structure 3-5 
concepts 9-22 
online structure 6,7 
system reguirements 
Machine configuration 25 
programming 24 


target seyment 18 

teleprocessing (see CICS/VS; online system) 
traditional data organization 2,11 

tree structure 11,17 


twin segment 12 


unidirectional logical relationships 14 
user interface 19-20 

user responsibilities 22-23,8 

utility programs 8,22-23 


VANDL-1 (Vancouver Data Language 
One) 19,22,8 
VSAM (virtual storage access method) 
proyramminyg systems reguirement 24 
storage requirements 26 
use by batch system 4,5,20-21 
use by online system 6,20-21 
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